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ABOUT THIS CHAPTER 


This chapter introduces you to the "inside" of Macintosh: the Operating System 
and User Interface Toolbox routines that your application program will call. It 
will help you figure out which software you need to learn more about and how to 
proceed with the rest of the Inside Macintosh documentation. To orient you to 
the software, it presents a simple example program. 
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OVERVIEW OF THE SOFTWARE 


The routines available for use in Macintosh programs are divided according to 
function, into what are in most cases called "managers" of the feature that they 
Support. AS shown in Figure 1, most are part of either the Operating System or 
the User Interface Toolbox and are in the Macintosh ROM. 


The Operating System is at the lowest level; it does basic tasks such as input 
and output, memory management, and interrupt handling. The User Interface 
Toolbox is a level above the Operating System; it helps you implement the 
standard Macintosh user interface in your application. The Toolbox calls the 
Operating System to do low-level operations, and you'll also call the Operating 
System directly yourself. 


RAM-based software is available as well. In most cases this software performs 
specialized operations (such as floating-point arithmetic) that aren't integral 
to the user interface but may be useful to some applications. 


The Toolbox and Other High-Level Software 


The Macintosh User Interface Toolbox provides a simple means of constructing 
application programs that conform to the standard Macintosh user interface. By 
offering a common set of routines that every application calls to implement the 
user interface, the Toolbox not only ensures familiarity and consistency for the 
user but also helps reduce the application's code size and development time. At 
the same time, it allows a great deal of flexibility: An application can use 
its own code instead of a Toolbox call wherever appropriate, and can define its 
own types of windows, menus, controls, and desk accessories. 


Figure 2 shows the various parts of the Toolbox in rough order of their relative 
level. There are many interconnections between these parts; the higher ones 
often call those at the lower levels. A brief description of each part is given 
below, to help you figure out which ones you'll need to learn more about. 
Details are given in the Inside Macintosh chapter on that part of the Toolbox. 
The basic Macintosh terms used below are explained in Macintosh, the owner's 
guide. 


To keep the data of an application separate from its code, making the data 
easier to modify and easier to share among applications, the Toolbox includes 
the Resource Manager. The Resource Manager lets you, for example, store menus 
separately from your code so that they can be edited or translated without 
requiring recompilation of the code. It also allows you to get standard data, 
such as the I-beam pointer for inserting text, from a shared system file. When 
you call other parts of the Toolbox that need access to the data, they call the 
Resource Manager. Although most applications never need to call the Resource 
Manager directly, an understanding of the concepts behind it is essential 
because they're basic to so many other operations. 
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Figure 1-Overview 
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Figure 2—Parts of the Toolborz 


Figure 2-Parts of the Toolbox 


Graphics are an important part of every Macintosh application. All graphic 
operations on the Macintosh are performed by QuickDraw. To draw something on the 
screen, you'll often call one of the other parts of the Toolbox, but it will in 
turn call QuickDraw. You'll also call QuickDraw directly, usually to draw inside 
a window, or just to set up constructs like rectangles that you'll need when 
making other Toolbox calls. QuickDraw's underlying concepts, like those of the 
Resource Manager, are important for you to understand. 


Graphics include text as well as pictures. To draw text, QuickDraw calls the 
Font Manager, which does the background work necessary to make a variety of 
character fonts available in various sizes and styles. Unless your application 
includes a font menu, you need to know only a minimal amount about the Font 
Manager. 


An application decides what to do from moment to moment by examining input from 
the user in the form of mouse and keyboard actions. It learns of such actions by 
repeatedly calling the Toolbox Event Manager (which in turn calls another, 
lower-level Event Manager in the Operating System). The Toolbox Event Manager 
also reports occurrences within the application that may require a response, 
such as when a window that was overlapped becomes exposed and needs to be 
redrawn. 


ALL information presented by a standard Macintosh application appears in 
windows. To create windows, activate them, move them, resize them, or close 
them, you'll call the Window Manager. It keeps track of overlapping windows, so 
you can manipulate windows without concern for how they overlap. For example, 
the Window Manager tells the Toolbox Event Manager when to inform your 
application that a window has to be redrawn. Also, when the user presses the 
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mouse button, you call the Window Manager to learn which part of which window it 
was pressed in, or whether it was pressed in the menu bar or a desk accessory. 


Any window may contain controls, such as buttons, check boxes, and scroll bars. 
You can create and manipulate controls with the Control Manager. When you learn 
from the Window Manager that the user pressed the mouse button inside a window 
containing controls, you call the Control Manager to find out which control it 
was pressed in, if any. 


A common place for the user to press the mouse button is, of course, in the menu 
bar. You set up menus in the menu bar by calling the Menu Manager. When the user 
gives a command, either from a menu with the mouse or from the keyboard with the 
Command key, you call the Menu Manager to find out which command was given. 


To accept text typed by the user and allow the standard editing capabilities, 
including cutting and pasting text within a document via the Clipboard, your 
application can call TextEdit. TextEdit also handles basic formatting such as 
word wraparound and justification. You can use it just to display text if you 
like. 


When an application needs more information from the user about a command, it 
presents a dialog box. In case of errors or potentially dangerous situations, it 
alerts the user with a box containing a message or with sound from the 
Macintosh's speaker (or both). To create and present dialogs and alerts, and 
find out the user's responses to them, you call the Dialog Manager. 


Every Macintosh application should support the use of desk accessories. The user 
opens desk accessories through the Apple menu, which you set up by calling the 
Menu Manager. When you learn that the user has pressed the mouse button in a 
desk accessory, you pass that information on to the accessory by calling the 
Desk Manager. The Desk Manager also includes routines that you must call to 
ensure that desk accessories work properly. 


As mentioned above, you can use TextEdit to implement the standard text editing 
capability of cutting and pasting via the Clipboard in your application. To 
allow the use of the Clipboard for cutting and pasting text or graphics between 
your application and another application or a desk accessory, you need to call 
the Scrap Manager. 


Some generally useful operations such as fixed-point arithmetic, string 
manipulation, and logical operations on bits may be performed with the Toolbox 
Utilities. 


The final part of the Toolbox, the Package Manager, lets you use RAM-based 
software called packages. The Standard File Package will be called by every 
application whose File menu includes the standard commands for saving and 
Opening documents; it presents the standard user interface for specifying the 
document. Two of the Macintosh packages can be seen as extensions to the Toolbox 
Utilities: The Binary-Decimal Conversion Package converts integers to decimal 
strings and vice versa, and the International Utilities Package gives you access 
to country-dependent information such as the formats for numbers, currency, 
dates, and times. 
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The Operating System and Other Low-Level Software 


The Macintosh Operating System provides the low-level support that applications 
need in order to use the Macintosh hardware. As the Toolbox is your program's 
interface to the user, the Operating System is its interface to the Macintosh. 


The Memory Manager dynamically allocates and releases memory for use by 
applications and by the other parts of the Operating System. Most of the memory 
that your program uses is in an area called the heap; the code of the program 
itself occupies space in the heap. Memory space in the heap must be obtained 
through the Memory Manager. 


The Segment Loader is the part of the Operating System that loads application 
code into memory to be executed. Your application can be loaded all at once, or 
you can divide it up into dynamically loaded segments to economize on memory 
usage. The Segment Loader also serves as a bridge between the Finder and your 
application, letting you know whether the application has to open or print a 
document on the desktop when it starts up. 


Low-level, hardware-related events such as mouse-button presses and keystrokes 
are reported by the Operating System Event Manager. (The Toolbox Event Manager 
then passes them to the application, along with higher-level, software-generated 
events added at the Toolbox level.) Your program will ordinarily deal only with 
the Toolbox Event Manager and will rarely call the Operating System Event 
Manager directly. 


File I/0 is supported by the File Manager, and device I/0 by the Device Manager. 
The task of making the various types of devices present the same interface to 
the application is performed by specialized device drivers. The Operating System 
includes three built-in drivers: 


« The Disk Driver controls data storage and retrieval on 3 1/2-inch disks. 

¢ The Sound Driver controls sound generation, including music composed 
of up to four simultaneous tones. 

e The Serial Driver reads and writes asynchronous data through the two 
serial ports, providing communication between applications and serial 
peripheral devices such as a modem or printer. 


The above drivers are all in ROM; other drivers are RAM-based. There's a Serial 
Driver in RAM as well as the one in ROM, and there's a Printer Driver in RAM 
that enables applications to print information on any variety of printer via the 
same interface (called the Printing Manager). The AppleTalk Manager is an 
interface to a pair of RAM drivers that enable programs to send and receive 
information via an AppleTalk network. More RAM drivers can be added 
independently or built on the existing drivers (by calling the routines in those 
drivers). For example, the Printer Driver was built on the Serial Driver, and a 
music driver could be built on the Sound Driver. 


The Macintosh video circuitry generates a vertical retrace interrupt 60 times a 
second. An application can schedule routines to be executed at regular intervals 
based on this "heartbeat" of the system. The Vertical Retrace Manager handles 
the scheduling and execution of tasks during the vertical retrace interrupt. 


If a fatal system error occurs while your application is running, the System 
Error Handler assumes control. The System Error Handler displays a box 
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containing an error message and provides a mechanism for the user to start up 
the system again or resume execution of the application. 


The Operating System Utilities perform miscellaneous operations such as getting 
the date and time, finding out the user's preferred speaker volume and other 
preferences, and doing simple string comparison. (More sophisticated string 
comparison routines are available in the International Utilities Package. ) 


Finally, there are three Macintosh packages that perform low-level operations: 
the Disk Initialization Package, which the Standard File Package calls to 
initialize and name disks; the Floating-Point Arithmetic Package, which supports 
extended-precision arithmetic according to IEEE Standard 754; and the 
Transcendental Functions Package, which contains trigonometric, logarithmic, 
exponential, and financial functions, as well as a random number generator. 
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A SIMPLE EXAMPLE PROGRAM 


To illustrate various commonly used parts of the software, this section presents 
an extremely simple example of a Macintosh application program. Though too 
simple to be practical, this example shows the overall structure that every 
application program will have, and it does many of the basic things every 
application will do. By looking it over, you can become more familiar with the 
software and see how your own program code will be structured. 


The example program's source code is shown at the end of this chapter, which 
begins at the end of this section. A lot of comments are included so that you 
can see which part of the Toolbox or Operating System is being called and what 
operation is being performed. These comments, and those that follow below, may 
contain terms that are unfamiliar to you, but for now just read along to get the 
general idea. All the terms are explained at length within Inside Macintosh. If 
you want more information right away, you can look up the terms in the Glossary 
or the Index. 


The application, called Sample, displays a single, fixed-size window in which 
the user can enter and edit text (see Figure 3). It has three menus: the 
standard Apple menu, from which desk accessories can be chosen; a File menu, 
containing only a Quit command; and an Edit menu, containing the standard 
editing commands Undo, Cut, Copy, Paste, and Clear. The Edit menu also includes 
the standard keyboard equivalents for Undo, Cut, Copy, and Paste: Command-Z, 
X, C, and V, respectively. The Backspace key may be used to delete, and Shift- 
clicking will extend or shorten a selection. The user can move the document 
window around the desktop by dragging it by its title bar. 
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Paste SU 
Clear 


Figure 3-The Sample Application 
Figure 3-The Sample Application 


The Undo command doesn't work in the application's document window, but it and 
all the other editing commands do work in any desk accessories that allow them 
(the Note Pad, for example). Some standard features this simple example doesn't 
Support are as follows: 


¢ Text cannot be cut (or copied) and pasted between the document 
and a desk accessory. 

e The pointer remains an arrow rather than changing to an I-beam 
within the document. 

¢ Except for Undo, editing commands aren't dimmed when they don't 
apply (for example, Cut or Copy when there's no text selection). 


The document window can't be closed, scrolled, or resized. Because the File menu 
contains only a Quit command, the document can't be saved or printed. Also, the 
application doesn't have "About Sample..." as the first command in its Apple 
menu, or a Hide/Show Clipboard command in its Edit menu (for displaying cut or 
copied text). 


In addition to the code shown at the end of this chapter, the Sample application 
has a resource file that includes the data listed below. The program uses the 
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numbers in the second column to identify the resources; for example, it makes a 
Menu Manager call to get menu number 128 from the resource file. 


Resource Resource ID Description 

Menu 128 Menu with the apple symbol as its title 
and no commands in it 

Menu 129 File menu with one command, Quit, with 
keyboard equivalent Command-Q 

Menu 130 Edit menu with the commands Undo (dimmed), 


Cut, Copy, Paste, and Clear, in that order, 
with the standard keyboard equivalents and 
with a dividing line between Undo and Cut 
Window 128 Document window without a size box; 
template top left corner of (50,40) on QuickDraw's 
coordinate plane, bottom right corner of 
(300,450); title "Sample"; no close box 


Each menu resource also contains a “menu ID" that's used to identify the menu 
when the user chooses a command from it; for all three menus, this ID is the 
same as the resource ID. 


Note: To create a resource file with the above contents, you can use the 
Resource Editor or any similar program that may be available on the 
development system you're using. 


The program starts with a USES clause that specifies all the necessary Pascal 
interface files. (The names shown are for the Lisa Workshop development system, 
and may be different for other systems.) This is followed by declarations of 
some useful constants, to make the source code more readable. Then there are a 
number of variable declarations, some having simple Pascal data types and others 
with data types defined in the interface files (like Rect and WindowPtr). 
Variables used in the program that aren't declared here are global variables 
defined in the interface to QuickDraw. 


The variable declarations are followed by two procedure declarations: 
SetUpMenus and DoCommand. You can understand them better after looking at the 
main program and seeing where they're called. 


The program begins with a standard initialization sequence. Every application 
will need to do this same initialization (in the order shown), or something 
close to it. 


Additional initialization needed by the program follows. This includes setting 
up the menus and the menu bar (by calling SetUpMenus) and creating the 
application's document window (reading its description from the resource file 
and displaying it on the screen). 


The heart of every application program is its main event loop, which repeatedly 
calls the Toolbox Event Manager to get events and then responds to them as 
appropriate. The most common event is a press of the mouse button; depending on 
where it was pressed, as reported by the Window Manager, the sample program may 
execute a command, move the document window, make the window active, or pass the 
event on to a desk accessory. The DoCommand procedure takes care of executing a 
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command; it looks at information received by the Menu Manager to determine which 
command to execute. 


Besides events resulting directly from user actions such as pressing the mouse 
button or a key on the keyboard, events are detected by the Window Manager as a 
side effect of those actions. For example, when a window changes from active to 
inactive or vice versa, the Window Manager tells the Toolbox Event Manager to 
report it to the application program. A similar process happens when all or part 
of a window needs to be updated (redrawn). The internal mechanism in each case 
is invisible to the program, which simply responds to the event when notified. 


The main event loop terminates when the user takes some action to leave the 
program-in this case, when the Quit command is chosen. 


That's it! Of course, the program structure and level of detail will get more 
complicated as the application becomes more complex, and every actual 
application will be more complex than this one. But each will be based on the 
structure illustrated here.PROGRAM Sample; 


{ Sample -- A small sample application written by Macintosh User } 
Education. It displays a single, fixed-size window in which the } 
user can enter and edit text. } 


{ 
{ 
{ The following two compiler commands are required } 
{ for the Lisa Workshop. } 

{$X-} {turn off automatic stack expansion} 

{$U-} {turn off Lisa libraries} 

{ 

{ 

{ 


The USES clause brings in the units containing the Pascal interfaces. } 
The $U expression tells the compiler what file to look in for the } 
specified unit. } 


USES {$U Obj/MemTypes } MemTypes, {basic Memory Manager data types} 
{$U Obj/QuickDraw} QuickDraw, {interface to QuickDraw} 
{$U Obj/OSIntf } OSIntf, {interface to the Operating System} 
{$U Obj/ToolIntf } ToolIntf; {interface to the Toolbox} 


CONST 
appleID = 128; {resource IDs/menu IDs for Apple, File, and Edit menus} 
fileID = 129; 
editID = 130; 
appleM = 1; {index for each menu in myMenus (array of menu handles) } 
fileM = 2; 
editM = 3° 
menuCount = 3; {total number of menus} 
window1ID = 128; {resource ID for application's window} 
undoCommand = 1; {menu item numbers identifying commands in Edit menu} 
cutCommand = 3; 
copyCommand = 4; 
pasteCommand = 5; 
clearCommand = 6; 
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VAR 
myMenus: ARRAY [l..menuCount] OF MenuHandle; {array of handles to the menus} 


dragRect: Rect; {rectangle used to mark boundaries for} 
{dragging window} 

txRect: Rect; {rectangle for text in application window} 

textH: TEHandle; {handle to information about the text} 

theChar: CHAR; {character typed on the keyboard or keypad} 

extended: BOOLEAN; {TRUE if user is Shift-clicking} 

doneFlag: BOOLEAN; {TRUE if user has chosen Quit command} 

myEvent: EventRecord; {information about an event} 

wRecord: WindowRecord; {information about the application window} 

myWindow: WindowPtr; {pointer to wRecord} 

whichWindow: WindowPtr; {pointer to window in which mouse button} 


{was pressed} 


PROCEDURE SetUpMenus; 
{ Set up menus and menu bar } 


VAR 
i: INTEGER; 


BEGIN 
{ Read menu descriptions from resource file into memory and store handles } 
{ in myMenus array } 
myMenus[appleM] := GetMenu(appleID); {read Apple menu from resource file} 
AddResMenu(myMenus[appleM], 'DRVR'); {add desk accessory names to} 
{Apple menu} 
GetMenu(fileID) ; {read File menu from resource file} 
GetMenu(editID) ; {read Edit menu from resource file} 


myMenus[fileM] 
myMenus [editM] 


FOR i := lL TO menuCount DO InsertMenu(myMenus[i], 0); {install menus in} 
{menu bar } 
DrawMenuBar; {and draw menu bar} 
END; {of SetUpMenu} 


PROCEDURE DoCommand(mResult: LONGINT) ; 
{ Execute command specified by mResult, the result of MenuSelect } 


VAR 
theItem: INTEGER; {menu item number from mResult low-order word) 
theMenu: INTEGER; {menu number from mResult high-order word} 
name: Str255; {desk accessory name} 
temp: INTEGER; 


BEGIN 
theItem := LoWord(mResult); {call Toolbox Utility routines to set } 
theMenu := HiWord(mResult); { menu item number and menu number} 
CASE theMenu OF {case on menu ID} 
appleID: 
BEGIN {call Menu Manager to get desk accessory } 


GetItem(myMenus[appleM], theItem, name); { name, and call Desk } 
{ Manager to open } 
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temp := OpenDeskAcc(name) ; { accessory (OpenDeskAcc 
{ result not used) } 
SetPort (myWindow) ; {call QuickDraw to restore application } 
END; {of appleID} { window as grafPort to draw in (may have } 
{ been changed during OpenDeskAccc) } 


fileID: doneFlag := TRUE; {quit (main loop repeats until} 
{doneFlag is TRUE) } 


editID: 
BEGIN {call Desk Manager to handle editing} 
{command if desk accessory window is} 
IF NOT SystemEdit(theItem - 1) { the active window} 
THEN {application window is the active window} 
CASE theItem OF {case on menu item (command) number} 


cutCommand: TECut(textH); {call TextEdit to handle command} 
copyCommand: TECopy(textH); 

pasteCommand: TEPaste(textH) ; 

clearCommand: TEDelete(textH) ; 


END; {of item case} 
END; {of editID} 


END; {of menu case} {to indicate completion of command, call } 
HiliteMenu(0); { Menu Manager to unhighlight menu title } 
{ (highlighted by MenuSelect) } 


END; {of DoCommand} 


BEGIN {main program} 
{ Initialization } 
InitGraf(@thePort) ; {initialize QuickDraw} 
InitFonts; {initialize Font Manager} 
FlushEvents(everyEvent, 0); {call OS Event Manager to discard} 
{ any previous events} 


InitWindows; {initialize Window Manager} 
InitMenus; {initialize Menu Manager} 
TEInit; {initialize TextEdit} 
InitDialogs(NIL) ; {initialize Dialog Manager} 
InitCursor; {call QuickDraw to make cursor (pointer) } 
{ an arrow} 
SetUpMenus; {set up menus and menu bar} 
WITH screenBits.bounds DO {call QuickDraw to set dragging boundaries; } 


{ ensure at least 4 by 4 pixels will remain} 
SetRect(dragRect, 4, 24, right - 4, bottom - 4); { visible} 


doneFlag := FALSE; {flag to detect when Quit command is chosen} 

myWindow := GetNewWindow(windowID, @wRecord, POINTER( - 1l)); {put up } 
{application} 
{window} 

SetPort (myWindow) ; {call QuickDraw to set current grafPort } 


{ to this window rectangle for text in} 
txRect := thePort*.portRect; { window; call QuickDraw to bring } 
InsetRect(txRect, 4, 0); { it in 4 pixels from left and right } 

{ edges of window } 
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textH := TENew(txRect, txRect); {call TextEdit to prepare for } 
{ receiving text} 


{ Main event loop } 
REPEAT {call Desk Manager to perform any periodic ) SystemTask; 
{ actions defined for desk accessories} 
TEIdle(textH) ; {call TextEdit to make vertical bar blink} 


IF GetNextEvent(everyEvent, myEvent) 
{call Toolbox Event Manager to get the next } 


THEN { event that the application should handle} 
CASE myEvent.what OF {case on event type} 
mouseDown: {mouse button down: call Window Manager} 


{ to learn where} 
CASE FindWindow(myEvent.where, whichWindow) OF 


inSysWindow: {desk accessory window: call Desk Manager} 
{to handle it} 
SystemClick {myEvent,whichWindow); inMenuBar: 
{menu bar: call Menu Manager to learn } 
{ which command, then execute it } 
DoCommand (MenuSelect (myEvent.where) ); 


inDrag: {title bar: call Window Manager to drag} 
DragWindow(whichWindow, myEvent.where, dragRect) ; 
inContent: {body of application window: } 
BEGIN { call Window Manager to check whether } 


IF whichWindow <> FrontWindow 
{ it's the active window and make it } 


THEN 
SelectWindow(whichWindow) { active if not} 
ELSE 
BEGIN {it's already active: call QuickDraw to } 


{ convert to window coordinates for } 
{ TEClick, use Toolbox Utility BitAnd to} 
{ test for Shift } 

GlobalToLocal (myEvent.where) ; 

extended := BitAnd(myEvent.modifiers, shiftKey) <> 0; 

TECLick(myEvent.where, extended, textH); 
{ key down, and call TextEdit} 

END; { to process the event} 
END; {of inContent} 
END; {of mouseDown} 


keyDown, autoKey: {key pressed once or held down to repeat} 
BEGIN 
theChar := CHR(BitAnd(myEvent.message, charCodeMask) ); 
{get the character} 
IF BitAnd(myEvent.modifiers, cmdKey) <> 0 


THEN {if Command key down, call Menu } 

DoCommand(MenuKey(theChar)) { Manager to learn which command, } 
ELSE { then execute it; else pass } 

TEKey(theChar, textH); { character to TextEdit} 


END; 
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activateEvt: 
BEGIN 
IF BitAnd(myEvent.modifiers, activeFlag) <> 0 THEN 
{application window is becoming active: } 
BEGIN { call TextEdit to highlight selection} 
TEActivate(textH) ; 
{ or display blinking vertical bar, and call} 
DisableItem(myMenus[editM], undoCommand) ; 
{ Menu Manager to disable Undo} 


END {(since application doesn't support Undo) } 
ELSE 
BEGIN {application window is becoming inactive: } 
TEDeactivate(textH) ; 


{ unhighlight selection or remove blinking} 
{ vertical bar, and enable Undo (since desk} 
{ accessory may support it)} 
EnableItem(myMenus[editM], undoCommand) ; 
END; 
END; {of activateEvt} 


updateEvt: {window appearance needs updating} 
BEGIN 
BeginUpdate (WindowPtr(myEvent.message) ) ; 
{call Window Manager to begin update} 
EraseRect(thePort*.portRect) ; 
{Call QuickDraw to erase text area} 
TEUpdate(thePort*.portRect, textH); 
{call TextEdit to update the text} 
EndUpdate(WindowPtr(myEvent.message) ); 
{call Window Manager to end update} 
END; {of updateEvt} 


END; {of event case} 
UNTIL doneFlag; 
END. 


WHERE TO GO FROM HERE 


This section contains important directions for every reader of Inside Macintosh. 
It will help you figure out which chapters to read next. 


The Inside Macintosh chapters are ordered in such a way that you can follow it 
if you read through it sequentially. Forward references are given wherever 
necessary to any additional information that you'll need in order to fully 
understand what's being discussed. Special-purpose information that can possibly 
be skipped is indicated as such. Most likely you won't need to read everything 
in each chapter and can even skip entire chapters. 


You should begin by reading the following chapters: 


1. The Macintosh User Interface Guidelines. All Macintosh 
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applications should follow these guidelines to ensure that the end 

user is presented with a consistent, familiar interface. 

Macintosh Memory Management: An Introduction. 

Using Assembly Language, if you're programming in assembly language. 

Depending on the debugging tools available on the development 

system you're using, it may also be helpful or necessary for high-level 

language programmers to read this chapter. You'll also have to read it 

if you're creating your own development system and want to know how to 
write interfaces to the routines. 

4. The chapters describing the parts of the Toolbox that deal with the 
fundamental aspects of the user interface: the Resource Manager, 
QuickDraw, the Toolbox Event Manager, the Window Manager, and the 
Menu Manager. 


WN 


Read the other chapters if you're interested in what they discuss, which you 
should be able to tell from the overviews in this "road map" and from the 
introductions to the chapters themselves. Each chapter's introduction will also 
tell you what you should already know before reading that chapter. 


When you're ready to try something out, refer to the appropriate documentation 
for the development system you'll be using. 


END OF DOCUMENT 
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